home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 May / Macworld (1999-05).dmg / Shareware World / Comms & Internet / Client PPC / README < prev    next >
Text File  |  1999-02-12  |  13KB  |  201 lines

  1.                              
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11. Description:
  12. Unlike the original Mixmaster 2.0.3 written for Unix, the Mac Mixmaster Client does not run as a mixmaster server, parsing incoming and outgoing e–mail messages, or generating keys.  Instead, it performs what hitherto has been unavailable to Mac users:  it prepares messages to be recieved by and passed on to Mixmaster (Type 2) remailers on the net.  Depending upon user input, it prepares messages by encrypting them with the public keys of the available mixmaster remailers, and produces the text which a users can send to them as part of an e–mail message.  
  13.  
  14. About this version:
  15. This version of the client is a brute port.  It does not have all the menus and buttons found in a normal MacOS application. Its graphical user interface is primitive at best.  It runs and feels like a Unix or DOS application, which means that it is rather unfriendly and unforgiving. Despite these drawbacks and despite my intention to release a more Mac–like version later, I have decided to release the brute port anyway, because Mac users have never had the opportunity to use Mixmaster mailers directly since their creation over four years ago. Many remailers now feature a “remix” option which allows anyone to enjoin the anonymity offered by a mixmaster remailer.  However, in order for Mac Users to recieve this extra level of security, they still have to spend the time preparing their Type 1 remailer messages using PGP 2.6.3.. Using this Mac Remailer Client, lets the user skip this tedious process.
  16.  
  17. While this port is based on the source code from that of Mixmaster 2.0.3, the messages that it generates are compatible with the newest version of Mixmaster 2.0.4 remailers.
  18.  
  19. Those of you with a PowerPC Macintosh should know that I haven’t been able to test the PowerPC version before I released it because I do not have access to a PowerPC Mac.  If the PowerPC version fails to run on your Mac, please let me know.  PowerPC users should be able to run the 68K version on their Macs in emulation as well.
  20.  
  21. Mac Mixmaster Client License
  22. This software is being distributed under the GNU Public License, see the file GNU License for more details.  The author assumes no liability for damages resulting from the use of this software, even if the damage results from defects in this software. No warranty is expressed or implied.
  23. This version of the Mac Mixmaster Client is absolutely free.
  24.  
  25. Setting up Mac Mixmaster Client:
  26. While the program itself will generate several files that it needs to run, you will need to update the application with the current list of Mixmaster(Type 2) remailers and their public keys.  These are found in the files type2.list and pubring.mix in the application`s folder.  The newest versions of these files can be found at the following web addresses:
  27. <http://anon.efga.org:8080/Remailers/type2.list>
  28. <http://anon.efga.org:800/Remailers/pubring.mix>
  29.  
  30. IMPORTANT
  31. Be sure to download text versions of these files rather than HTML versions.   Once you download these files into the Mac Mixmaster Client Folder, you cannot use them as is.  They are created by Unix computers and have correspondingly Linefeeds at the end of each text line .  You need to replace each of these Linefeeds with a Macintosh character return.  Rather than doing this by hand, you can download an excellent and small text editor program called Tex–Edit Plus from <http://www.nearside.com/trans–tex/>. It will convert text files between the Unix and the MacOS platforms.
  32.  
  33. Running the Mac Mixmaster Client:
  34. The application will prompt you for a series of responses.
  35. The first question it will ask is…
  36. Enter destination : 
  37. At this point enter the e–mail address of the recipient that you want the anonymous message sent to. After you have enter the e–mail message, press return. The application should ask you for another destination.  If you want to send the message to someone else, here is your chance to enter their e–mail address. If you don’t want to send the message to someone else, simply press return.
  38.  
  39. The second question it will ask is…
  40. Enter header :
  41. Respond by typing a number of possible headers for e–mail message.  The most common one is “Subject:”.  In case you want a subject header to appear, type at this time, for example, “Subject: Hello world!”.
  42.  
  43. The Mac Mixmaster Client will now show you a list of the addresses of the possible Mixmaster (Type 2) anonymous remailers.
  44. #1 athena@cyberpass.net
  45. #2 blackbird@cpis.net
  46. #3 remailer@anon.efga.org
  47. #4 mixmaster@ecn.org
  48. #5 mix@seclab.com
  49. #6 mixmaster@fitug.de
  50. #7 mixmaster@gsu.linux.org.tr
  51. #8 remailer@hr13.zedz.net
  52. #9 mixer@htp.org
  53. #10 mix@sind.hyperreal.art.pl
  54. #11 idgas@anon.myofb.org
  55. #12 mixmaster@as–node.jena.thur.de
  56. #13 mix@anon.lcs.mit.edu
  57. #14 remailer@lo14.wroc.pl
  58. #15 mixmaster@itech.net.au
  59. #16 mccain@notatla.demon.co.uk
  60. #17 mixmaster@remail.obscura.com
  61. #18 nightmare@uni–muenster.de
  62. #19 mixer@nowhere.to
  63. #20 mixer@anon.olymp.org
  64. #21 mixer@immd1.informatik.uni–erlangen.de
  65. #22 remailer@privacy.nb.ca
  66. #23 remailer@replay.com
  67. #24 remailer@samson.ml.org
  68. #25 mix@squirrel.owl.de
  69. #26 mix@remailer.ch
  70. #27 teatwo@notatla.demon.co.uk
  71. #28 mix@earth.wazoo.com
  72.  
  73. You will then be asked the following:
  74. Choose the remailers you want to use in your chain.
  75. Hit return when you are done.
  76. Enter remailer number:
  77. If you want the application to choose the remailers randomly for you enter zero and then return twice.  Otherwise, type in the numbers the application showed left of the remailer e–mail addresses.  Four remailers is quite enough.  Remember that the more you choose to include in your chain, the less likely the message will arrive at its destination.  You should also choose the most reliable remailers. A list that shows their reliability can be found here < http://anon.efga.org:8080/Remailers/TypeIIList>.
  78.  
  79. Fourth, the application will ask you the following question:
  80. Please enter the name of the file to chain:
  81. The kind of answer that it expects will only be familiar to those who understand how the MacOS represents the positions of folders and files with a string of characters. For instance, to encrypt the file “My Message” you must type in the full path, such as “Hard Drive:Desktop Folder:Messages to Send:My Message.” This tells the program to encrypt the file “My Message” on the drive “Hard Drive” in the folder “Desktop Folder” in the folder “Messages” to Send”.  Note that you must put a colon inbetween the disk name, the folder names and the file name; you must also pay attention to case, and include the spaces.
  82.  
  83. Finally, the last question the remailer will ask is the following:
  84. Please enter the name of the output file:
  85. Like the previous question, the application expects to receive a string of characters which indicate both the file name and the folders the file is found in.  For example, “Hard Drive:output.txt”.
  86.  
  87. You have finished giving the application all that it needs to produce the contents of a file that a Mixmaster Remailer can understand.  We will call this output the Cyphertext and it is stored in the file you told the program to save the information in.
  88. If you entered everything correctly, you should see the following message:
  89. The encryption was successful!
  90. You will find the prepared message
  91. in the file Hard Drive:output.txt 
  92. If the program failed, it will tell you. You will have to try again, by choosing the “New Sessions…”menu item of the File menu or by pressing the Command–N shortcut combination.
  93.  
  94.  
  95. If you have problems while the program is operating, press the Command–Period key combination to interrupt the program and quit.
  96.  
  97. If you fail to indicate a file that Mac Mixmaster Client will save its results to, it will write the results into the frontmost window.  To use this in an e–mail message, you must quit the program and it will ask you if you would like to save the information from the window into a file.  Indicate that you would like to save it, and enter the file name.  Now open this text in a text editor.
  98.  
  99. When you want Mac Mixmaster Client to encrypt an extremely large file, the client will create at least two or more cyphertext messages.  Each message will be stored in a file with its name suffixed by a number such as “output.txt1…output.txt2…etc”. You will need to edit and send each in separate in e–mail messages.
  100.  
  101. The results will be stored in a file of your choosing and the contents should look something like this.  This is the cyphertext:
  102.  
  103. To: remailer@replay.com
  104.  
  105.  
  106. ::
  107. Remailer-Type: Mixmaster 2.0.3
  108.  
  109. -----BEGIN REMAILER MESSAGE-----
  110. 20480
  111. OCUqVz1SSPlMVx338Ozhiw==
  112. 4+K01nMUthZe4DsLCuB6f4BeIzY=
  113. e2wOKzlIEVBHIoR25KExgKi3nD35AwovXE+XsTQF
  114.  
  115. //more and more junk
  116.  
  117. Nm2pkiR2tnh6Pxd9oFGh8J80T87WS3dgZ+KZcwJY
  118. iPTO2KucqgmTLgPlkZ5QDTpuoHyRu9JBIIRRJZcS
  119. –––––END REMAILER MESSAGE–––––
  120.  
  121.  
  122. To send this cyphertext to an anonymous remailer, you must edit this message, cut and/or paste it to a e–mail program.
  123.  1) you must cut the first line of the result (both the text “To: remailer@replay.com” and the invisible character return at the end of the text.)
  124. 2) paste only the remailer address “remailer@replay.com” into the “To:” field of the outgoing e–mail message.
  125. 3)  The message should now have 2 (and only 2) blank lines or character returns before the line with the “::”.   Cut and paste what remains, including the 2 blank lines, into the body of your e–mail message. 
  126.  
  127. If there is more than one cyphertext in the file, you must edit each one in the same way, and send each as a separate e–mail message.
  128.  
  129. When sending the text in an e–mail program, I have had no problems sending them with Eudora Light with the following settings turned off because they would change the text messages that the remailer would  recieve:
  130.  
  131.     No signature.
  132.     No MIME Quoted–Printable encoding.
  133.     No Word Wrap.
  134.  
  135.  
  136. Credits:
  137. Here is a list of all the sources of the code that I used to create this brute port:
  138. Original Source of Mixmaster 2.0.3.
  139. Copyright © 1995 by Lance M. Cottrell
  140.  <mailto:loki@obscura.com>
  141. < http://www.obscura.com/crypto.html>
  142.  
  143. RSAREF™ 2.0
  144. Copyright © 1994 by RSA Laboratories,
  145. a division of RSA Data Security, Inc., All rights reserved.
  146. <rsaref-administrator@rsa.com>
  147.  
  148. Moof: The Minimal Object-Oriented Framework
  149. by Joseph J. Strout
  150. <http://www.strout.net/info/coding/macdev/>
  151. <ftp://ftp.strout.net/pub/moof.sit.hqx>
  152.  
  153. SIOUX Simple Input/Output User Exchange
  154. by Berardino E. Baratta, Copyright © 1993-1995 Metrowerks Inc.  
  155. <http://www.metrowerks.com>
  156.  
  157. URandomLib
  158.  by Michael P. McLaughlin
  159. <mailto:mpmcl@mitre.org>
  160. <http://www.geocities.com/~mikemclaughlin/software/URandomLib.html>
  161.  
  162. Timeshift.c  of MacPGP 2.6.2
  163. Copyright © 1990-1994 by Philip Zimmermann 
  164. You can find the source starting here...
  165. <http://www-swiss.ai.mit.edu/~switz/PGP/>
  166.  
  167. Source Code for the About Box
  168. adapted from WEDemo Copyright © 1993-1998 Marco Piovanelli
  169. <http://www.boingo.com/waste/>
  170.  
  171. Source code and resources for the animated cursor
  172. are from Chapter 12’s demo program (GWorldPicCursIcon.c)
  173.  of  K. J. Bricknell’s great book, MACINTOSH C: 
  174. A Hobbyist’s Guide to Programming the Mac OS in C
  175. Version 1.1, ©1997
  176. <http://cafe.AmbrosiaSW.com/macintosh-c/ >
  177.  
  178. For a FAQ about Mixmaster Remailers
  179. <http://www.obscura.com/~loki/remailer/mixmaster-faq.html>
  180.  
  181.  
  182. Things to do
  183.  
  184. ----  Update source to that of Mixmaster 2.0.4
  185. ----    Redesign the user interface.
  186. ----    Get a better random number generator. URandomLib is only a pseudo–random number generator and, therefore, not truly random.  This is greatest weakness in the security provided by Mac Mixmaster Client.
  187. ----    Plug Port into PowerPlant application framework.
  188. ----    Use PP's network classes to allow the client to update its own files (type2list, pubring.mix, statistics, etc) using the Internet (http or finger)
  189. ----    Make it into a word services server.
  190. ----    Integrate it more tightly with a e–mail program, either through a plug–in or through apple–events.
  191. ----    Perhaps add applescript ability.
  192. ----    Add type 1 remailer support.
  193.  
  194. To contact the 'author' of this port, send e-mail to <mailto:wcrowshaw@geocities.com>
  195.  
  196. To verify that the copy of Mac Mixmaster Client is the one in which I have posted, you need to check the PGP 2.6.2 signature of the application file that I have included.  To do this, perform these steps.
  197. 1) Grab my PGP 2.6.2 public key ring from my home page and add it to your public key ring.
  198. 2) Using MacPGP Macbinarize the copy of the application found stuff and binhexed in the downloaded archive.
  199. 3) Open using MacPGP the separate signature file of that I have include in the archive.  It is called "Signature of MacMixmaster.asc"
  200. 4)MacPGP will ask you to indicate which file the signature belongs to.  Respond by selecting the Macbinarized version of the application that you have already created in step 2.
  201. 5) If the signature is correct, it will indicate.  If it is incorrect, this means that the copy of Mac Mixmaster Client that you are using is not the one that I personally signed.